
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>3、SpringAI 应用开发 - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>3、SpringAI 应用开发 - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">在SpringAI中，如何实现实时流式输出以提升用户体验？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">通过在Controller方法上使用`@GetMapping`注解，并设置`produces = MediaType.TEXT_EVENT_STREAM_VALUE`来实现。方法返回一个`Flux<String>`，它由`chatClient.stream(prompt)`调用生成，并将每个响应块的内容通过`map`操作符提取出来，形成一个事件流。</div>
          </div>
          <div class="card-source">来源: 1. 输出处理与优化 - 流式输出实现技术</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">当需要从AI响应中提取结构化数据（如JSON）时，应如何构建提示（Prompt）？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">应在提示中包含一个`SystemMessage`，明确指示AI模型必须以有效的JSON格式返回数据，并要求该格式需完全匹配目标Java类的结构（例如，通过提供类名`targetClass.getName()`）。</div>
          </div>
          <div class="card-source">来源: 1. 输出处理与优化 - 结构化数据提取方法</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">策略</div>
          <div class="card-question">文档中的错误处理与恢复策略是如何应对API速率限制（TOO_MANY_REQUESTS）的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">策略</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">当捕获到状态码为`TOO_MANY_REQUESTS`的`AiServiceException`时，系统会采用带指数退避（exponential backoff）的重试策略。它会暂停一段时间（`Thread.sleep`），且等待时间随重试次数增加而指数级增长，然后再重新尝试调用API。</div>
          </div>
          <div class="card-source">来源: 1. 输出处理与优化 - 错误处理与恢复策略</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">在智能客服系统中，处理客户查询的核心流程是怎样的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">核心流程包括五个步骤：1. 从知识库（VectorStore）中检索与查询相关的文档。2. 基于检索到的信息构建一个增强的系统提示（SystemMessage）。3. 结合对话历史和当前查询，构建完整的消息列表。4. 调用AI获取响应。5. 将当前问答对更新到对话历史中。</div>
          </div>
          <div class="card-source">来源: 2. 智能客服与知识库系统 - 智能客服系统架构与实现</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">将新文档添加到知识库（VectorStore）需要经过哪些步骤？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">主要分为三步：1. 使用`DocumentSplitter`将原始文档内容分割成多个文本段落（TextSegment）。2. 将每个段落转换为`Document`对象，并附加元数据（如来源、创建时间等）。3. 将这些`Document`对象列表添加到`VectorStore`中。</div>
          </div>
          <div class="card-source">来源: 2. 智能客服与知识库系统 - 知识库问答应用构建方法</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">除了生成摘要，`DocumentAnalysisService`展示了AI可以从文档中提取哪些类型的元数据？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">AI可以分析文档并提取结构化的元数据，返回一个JSON对象，其中包含：主题（topic）、关键词（keywords数组）、情感（sentiment，如积极/中性/消极）、复杂度（complexity，1-10分）以及主要实体（main entities数组）。</div>
          </div>
          <div class="card-source">来源: 3. 文档分析与内容生成 - 文档摘要与分析工具实现</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">优化</div>
          <div class="card-question">文档中的模型调用优化方法是如何根据任务复杂度来选择不同的大语言模型的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">优化</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">通过一个`TaskComplexity`枚举（SIMPLE, MEDIUM, COMPLEX）来区分任务。简单任务会选用成本更低、速度更快的模型（如`gpt-3.5`），并设置较少的最大令牌数；而复杂任务则会选用功能更强大的模型（如`gpt-4`），并分配更多的最大令牌数。</div>
          </div>
          <div class="card-source">来源: 4. 性能与质量保障 - 模型调用优化方法</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">策略</div>
          <div class="card-question">为了减少重复的API调用和成本，`AiResponseCacheService`采用了什么样的缓存策略？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">策略</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">该服务使用`CacheManager`实现缓存。在发起AI调用前，它会根据提示内容生成一个缓存键（cache key）。首先尝试从缓存中获取响应，如果命中则直接返回缓存结果；如果未命中，则调用AI，并将返回的新结果存入缓存以备后续使用。</div>
          </div>
          <div class="card-source">来源: 4. 性能与质量保障 - 缓存策略实现技术</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">安全</div>
          <div class="card-question">为了保护用户隐私，`SecureAiService`在将用户输入发送给AI之前采取了什么关键措施？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">安全</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">关键措施是检测和脱敏个人身份信息（PII）。它通过一个`detectAndSanitizePii`方法，使用正则表达式查找并替换输入文本中的电子邮件、手机号码、身份证号等敏感信息为占位符（如`[EMAIL]`、`[PHONE]`）。</div>
          </div>
          <div class="card-source">来源: 4. 性能与质量保障 - 安全与隐私保护措施</div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
